home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / C / Applications / Python 1.4 / libjpeg / djpeg.1 < prev    next >
Encoding:
Text File  |  1996-02-28  |  4.4 KB  |  188 lines  |  [TEXT/MPCC]
  1. .TH DJPEG 1 "2 August 1992"
  2. .SH NAME
  3. djpeg \- decompress a JPEG file to an image file
  4. .SH SYNOPSIS
  5. .B djpeg
  6. [
  7. .BI \-colors " N"
  8. ]
  9. [
  10. .B \-gif
  11. ]
  12. [
  13. .B \-pnm
  14. ]
  15. [
  16. .B \-rle
  17. ]
  18. [
  19. .B \-targa
  20. ]
  21. [
  22. .B \-blocksmooth
  23. ]
  24. [
  25. .B \-grayscale
  26. ]
  27. [
  28. .BI \-maxmemory " N"
  29. ]
  30. [
  31. .B \-nodither
  32. ]
  33. [
  34. .B \-onepass
  35. ]
  36. [
  37. .B \-verbose
  38. ]
  39. [
  40. .B \-debug
  41. ]
  42. [
  43. .I filename
  44. ]
  45. .LP
  46. .SH DESCRIPTION
  47. .LP
  48. .B djpeg
  49. decompresses the named JPEG file, or the standard input if no file is named,
  50. and produces an image file on the standard output.  PBMPLUS (PPM/PGM), GIF,
  51. Targa, or RLE (Utah Raster Toolkit) output format can be selected.  (RLE is
  52. supported only if the URT library is available.)
  53. .SH OPTIONS
  54. All switch names may be abbreviated; for example,
  55. .B \-grayscale
  56. may be written
  57. .B \-gray
  58. or
  59. .BR \-gr .
  60. Most of the "basic" switches can be abbreviated to as little as one letter.
  61. Upper and lower case are equivalent (thus
  62. .B \-GIF
  63. is the same as
  64. .BR \-gif ).
  65. British spellings are also accepted (e.g.,
  66. .BR \-greyscale ),
  67. though for brevity these are not mentioned below.
  68. .PP
  69. The basic switches are:
  70. .TP
  71. .BI \-colors " N"
  72. Reduce image to at most N colors.  This reduces the number of colors used in
  73. the output image, so that it can be displayed on a colormapped display or
  74. stored in a colormapped file format.  For example, if you have an 8-bit
  75. display, you'd need to reduce to 256 or fewer colors.
  76. .TP
  77. .BI \-quantize " N"
  78. Same as
  79. .BR \-colors .
  80. .B \-colors
  81. is the recommended name,
  82. .B \-quantize
  83. is provided only for backwards compatibility.
  84. .TP
  85. .B \-gif
  86. Select GIF output format.  Since GIF does not support more than 256 colors,
  87. .B \-colors 256
  88. is assumed (unless you specify a smaller number of colors).
  89. .TP
  90. .B \-pnm
  91. Select PBMPLUS (PPM/PGM) output format (this is the default format).
  92. PGM is emitted if the JPEG file is gray-scale or if
  93. .B \-grayscale
  94. is specified; otherwise PPM is emitted.
  95. .TP
  96. .B \-rle
  97. Select RLE output format.  (Requires URT library.)
  98. .TP
  99. .B \-targa
  100. Select Targa output format.  Gray-scale format is emitted if the JPEG file is
  101. gray-scale or if
  102. .B \-grayscale
  103. is specified; otherwise, colormapped format is emitted if
  104. .B \-colors
  105. is specified; otherwise, 24-bit full-color format is emitted.
  106. .PP
  107. Switches for advanced users:
  108. .TP
  109. .B \-blocksmooth
  110. Perform cross-block smoothing.  This is quite memory-intensive and only seems
  111. to improve the image at very low quality settings (\fB\-quality\fR 10 to 20 or
  112. so).  At normal quality settings it may make the image worse.
  113. .TP
  114. .B \-grayscale
  115. Force gray-scale output even if JPEG file is color.
  116. Useful for viewing on monochrome displays.
  117. .TP
  118. .BI \-maxmemory " N"
  119. Set limit for amount of memory to use in processing large images.  Value is
  120. in thousands of bytes, or millions of bytes if "M" is attached to the
  121. number.  For example,
  122. .B \-max 4m
  123. selects 4000000 bytes.  If more space is needed, temporary files will be used.
  124. .TP
  125. .B \-nodither
  126. Do not use dithering in color quantization.  By default, Floyd-Steinberg
  127. dithering is applied when quantizing colors, but on some images dithering may
  128. result in objectionable "graininess".  If that happens, you can turn off
  129. dithering with
  130. .BR \-nodither .
  131. .B \-nodither
  132. is ignored unless you also say
  133. .B \-colors
  134. .IR N .
  135. .TP
  136. .B \-onepass
  137. Use one-pass instead of two-pass color quantization.  The one-pass method is
  138. faster and needs less memory, but it produces a lower-quality image.
  139. .B \-onepass
  140. is ignored unless you also say
  141. .B \-colors
  142. .IR N .
  143. Also, the one-pass method is always used for gray-scale output (the two-pass
  144. method is no improvement then).
  145. .TP
  146. .B \-verbose
  147. Enable debug printout.  More
  148. .BR \-v 's
  149. give more output.  Also, version information is printed at startup.
  150. .TP
  151. .B \-debug
  152. Same as
  153. .BR \-verbose .
  154. .SH EXAMPLES
  155. .LP
  156. This example decompresses the JPEG file foo.jpg, automatically quantizes to
  157. 256 colors, and saves the output in GIF format in foo.gif:
  158. .IP
  159. .B djpeg \-gif
  160. .I foo.jpg
  161. .B >
  162. .I foo.gif
  163. .SH ENVIRONMENT
  164. .TP
  165. .B JPEGMEM
  166. If this environment variable is set, its value is the default memory limit.
  167. The value is specified as described for the
  168. .B \-maxmemory
  169. switch.
  170. .B JPEGMEM
  171. overrides the default value specified when the program was compiled, and
  172. itself is overridden by an explicit
  173. .BR \-maxmemory .
  174. .SH SEE ALSO
  175. .BR cjpeg (1)
  176. .br
  177. .BR ppm (5),
  178. .BR pgm (5)
  179. .br
  180. Wallace, Gregory K.  "The JPEG Still Picture Compression Standard",
  181. Communications of the ACM, April 1991 (vol. 34, no. 4), pp. 30-44.
  182. .SH AUTHOR
  183. Independent JPEG Group
  184. .SH BUGS
  185. Arithmetic coding is not supported for legal reasons.
  186. .PP
  187. Still not as fast as we'd like.
  188.